home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / comms / ts3j.zip / RUNT.DOC < prev    next >
Text File  |  1994-11-08  |  16KB  |  401 lines
  1.  
  2.  
  3.                RUNT -  The RUN Timer  Manual          Page 1
  4.  
  5.  
  6.  
  7.  
  8.                         _______
  9.                    ____|__     |               (R)
  10.                 --|       |    |-------------------
  11.                   |   ____|__  |  Association of
  12.                   |  |       |_|  Shareware
  13.                   |__|   o   |    Professionals
  14.                 -----|   |   |---------------------
  15.                      |___|___|    Member
  16.  
  17.  
  18.  
  19.                 Version 4.50  November, 1994
  20.  
  21.  
  22.  
  23.  
  24.  
  25.           The RUNT is an ASP member Shareware product.
  26.  
  27.           The RUNT program provides password access control, screen
  28.           saver capability, and basic events management, both singly and
  29.           in various combinations as your needs and imagination decree.
  30.           For example, you can setup password controlled access to a
  31.           'screen saver' that simply displays quotes from a quotes
  32.           database.  With two more switches you can allow the user to
  33.           quit or swap to DOS, reboot the machine if he/she cannot pass
  34.           the password test.  The RUNT is normally distributed with
  35.           TeleShare, Hands On, and the OpMenu system, and can be found
  36.           in other places.
  37.  
  38.  
  39.           Optional command line usage:
  40.  
  41.           -B[filename]  Use the built-in quotes reader.
  42.           -C to Create the calldata.dbf.
  43.           -D99 Seconds to Delay.
  44.           -E  A simple password file editor.
  45.           -Fname  To specify an alternate command file.
  46.           -FX  To disable using a command file.
  47.           -Gprogram   The program to Go to when someone signs on.
  48.           -H for the usage screen.
  49.           -Iprogram to run immediately.  Such as a 'quotes' program.
  50.           -L List people currently having password access.
  51.           -P[password] to enter the system.
  52.           -Q Allow the password user to Quit on request.
  53.           -QS As above, but swap the program to disk instead of quitting.
  54.           -S  to tell the RUNT to swap to the PROGRAM, specified in
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                RUNT -  The RUN Timer  Manual          Page 2
  61.  
  62.  
  63.           the command file (or tsphone).
  64.           -Xprogram to run if the user fails the password test.
  65.  
  66.  
  67.           Password/Access Control
  68.  
  69.           You use the -Ppassword switch to add password capability.  The
  70.           password (up to 15 characters) can be supplied with the -P, or
  71.           the -P can be used by itself and the password will be sought
  72.           in the password database.  The RUNT will first ask for your
  73.           name (up to three times), assuming case sensitivity, and look
  74.           it up in the database.  It will then ask for your password and
  75.           either match to the command line "-Pmy_pass" or look it up in
  76.           the database.  If you use the -Q switch, anyone successfully
  77.           passing the password test will be given the option to quit the
  78.           RUNT and continue using other software on the machine.  The
  79.           -QS option swaps all but 2K of the RUNT to disk, so the user
  80.           can simply EXIT when finished to reassure password
  81.           protection.  The -Gsome.exe switch tells the RUNT to run or Go
  82.           to the provided program or batch file once you have passed the
  83.           password test.  Note that just using -P without -G, -Q, or -QS
  84.           can effectively lock the RUNT into its current settings until
  85.           you reboot the machine.  The -E switch provides a simple
  86.           editor so you can directly edit the password database, which
  87.           is called CALLDATA.DBF.  The database is the same as that
  88.           found in the TeleShare/DOS remote support system.  Starting
  89.           with version 4.50 the passwords are encrypted based on a
  90.           master password stored in the binary RUNT.CFG configuration
  91.           file.  When you, as password administrator, create the set of
  92.           allowable passwords, using "RUNT -e" the RUNT will initially
  93.           ask for your master password which is the current date and
  94.           time formatted as in 01/30/9514:5.  Then the RUNT will ask you
  95.           for your new unique password, and will allow you to enter
  96.           names and passwords.  You will be able to use the same new
  97.           master password with "RUNT -E" to add and edit names and
  98.           passwords on a continuing basis.  The master password may be
  99.           up to 50 characters long.  You should be very careful how you
  100.           enter it because you will get no hints or second chances to
  101.           review the password.  The 'normal' password is only 12
  102.           characters long.
  103.  
  104.  
  105.           The structure of the CALLDATA.DBF table or database is as
  106.           follows:
  107.  
  108.                      No.   Field Name   Type   Length  Decimals
  109.                      ===========================================
  110.                        1   KEYNUM        C        5      0
  111.                        2   IDENTITY      C       20      0
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                RUNT -  The RUN Timer  Manual          Page 3
  118.  
  119.  
  120.                        3   PHONEDESC     C       10      0
  121.                        4   PHONENUM      C       21      0
  122.                        5   PASSWORD      C       12      0
  123.                        6   UPDATED       D        8      0
  124.                      ===========================================
  125.  
  126.           If there is no CALLDATA.DBF password database, the RUNT will
  127.           only ask for a password and will only attempt to compare with
  128.           the command line password.  It will accept "-P" as a zero
  129.           length password.  It will also enter the nasty infinite loop
  130.           if you do not specify another action should the user fail the
  131.           password test.
  132.  
  133.           Use -Xexit.exe to specify what the RUNT should do if the
  134.           user/you fail to pass the the password test.  Using tools
  135.           distributed with TeleShare you can specify that the machine
  136.           "REBOOT" or "HANGUP", via a batch file, if a telephone
  137.           connection is involved.  You can specify some other preferred
  138.           action if you like.  The current default is to enter an
  139.           infinite loop beeping and announcing the password failure.
  140.           Use something like "-XDIR/W" while you are testing/setting up
  141.           the RUNT for your uses.
  142.  
  143.           Note that just using -P without -G, -Q, or -QS can effectively
  144.           lock the RUNT into its current settings until you reboot the
  145.           machine.
  146.  
  147.  
  148.  
  149.           Screen Savers
  150.  
  151.           There are three options:
  152.  
  153.           1) The normal events management system includes a simple
  154.           "Press any key" screen saver.
  155.  
  156.           2) You can use the -Immediate switch to specify an alternate
  157.           repeating screen saver program, such as a quotes generator.
  158.           Its often useful to also use the -Delay switch to control the
  159.           number of seconds the quote (or whatever) is on display.  A
  160.           sample command line would then be "RUNT -IQUOTE -D3" to run
  161.           the QUOTE program every 3 seconds.
  162.  
  163.           3) Use the -B switch to tell the RUNT to use the QUOTES.DAT
  164.           quote database file.  Using -Bother.dat will tell it to use
  165.           the 'other.dat' file.  A likely command line might be "RUNT -B
  166.           -D3".  The quotes file that the built-in reader uses must use
  167.           # symbols to separate quotes as in:
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                RUNT -  The RUN Timer  Manual          Page 4
  175.  
  176.  
  177.           #Education is not the filling of a pail, but the lighting
  178.           of a fire.                         - William Butler Yeats
  179.           #TV is chewing gum for the eyes.
  180.                                              - Frank Lloyd Wright
  181.  
  182.           Naturally, you can add -P for password protection, -FX to
  183.           disable events actions, and so on, with your 'screen saver'
  184.           choice.
  185.  
  186.  
  187.  
  188.  
  189.           Events Management
  190.  
  191.           The original purpose of the RUNT was to allow you to run any
  192.           software at timed intervals.  The idea is that you may well
  193.           have tasks that can be done with minimal or no human
  194.           intervention, over a break like tea time, lunch, or
  195.           overnight.  The RUNT takes a set of up to 30 programs to run
  196.           from the TODO_NOW or EVENTS.NOW text command file, and then
  197.           runs them at specified times.  If you put instructions for
  198.           previous hours in the command file, the RUNT will only grab
  199.           the previous hour's commands.  It will treat the remainder as
  200.           instructions for the next day.  The runt defaults to swapping
  201.           all but 2K of itself out to disk when it runs another
  202.           program.
  203.  
  204.           The switches normally used with events management are:
  205.  
  206.  
  207.           Combinations with the password and 'screen saver' switches.
  208.  
  209.           -Fsomefile to specify an alternate to the TODO_NOW or EVENTS.NOW
  210.           events command files.
  211.  
  212.           -FX to disable looking for and using a command file.
  213.  
  214.           -S to specify a program to Swap to to renew the command file.
  215.  
  216.           or no switch.
  217.  
  218.           You can just type in "RUNT" and wait as it looks, first in the
  219.           current directory, then in the same directory as its .EXE, for
  220.           a current copy of the command file.  It grabs its setup
  221.           information from the file, sets itself up and runs.  If there
  222.           is no current command file, or no current entries it
  223.           complains.  If you wish you can use another setup file as a
  224.           parameter with the RUNT as shown with "RUNT \mystuff\ToBeRun"
  225.           in place of, or in addition to, the command file.  This allows
  226.  
  227.  
  228.  
  229.  
  230.  
  231.                RUNT -  The RUN Timer  Manual          Page 5
  232.  
  233.  
  234.           you to have many programs to run, and to repeatedly cycle
  235.           through the runs (eg for testing or other repeating
  236.           activities).  The RUNT automatically rereads the setup file
  237.           each hour, which allows another process to renew the file for
  238.           it and reloads the runs that are repeated every hour.
  239.  
  240.  
  241.           Some years of instructions for programs to run can be stored
  242.           in the events.dbf database.  These values are transferred to
  243.           the command file (EVENTS.NOW) using TSPHONE.  See the
  244.           TSPHONE.DOC and the online help in TSPHONE.
  245.  
  246.           Programs like OPMENU and TSPHONE allow you to run many more
  247.           than 30 programs with more flexibility by adding multiple
  248.           entry numbers on the RUNT program to be run line as in "OPMENU
  249.           -R 1 4 67 213 9917".  With each entry number then running one
  250.           after the previous at and after the time specified for the
  251.           entry.  Plus each entry can easily contain instructions to run
  252.           several programs in programmed sequence.
  253.  
  254.           CHECKDATE
  255.           Adding "CHECKDATE" early in the instructions for the file
  256.           tells RUNT to only use the file if it is current and has
  257.           today's file date.  The RUNT quits if there is no current
  258.           script file.
  259.  
  260.           DELAY 25
  261.           Delay allows you to change the display reading time in
  262.           seconds.  The default value is 15 seconds.  See also WAIT
  263.           below.
  264.  
  265.           NOSWAP
  266.           Adding "NOSWAP" on the program to run line tells the RUNT not
  267.           to swap itself to disk before running the program.  This is
  268.           somewhat faster and quite feasable when running most general
  269.           utility programs.  The RUNT occupies about 100k when running
  270.           another program using NOSWAP.
  271.  
  272.           PROGRAM
  273.           Use "PROGRAM" followed by the program name to tell the runt
  274.           which program to swap to, as in "PROGRAM TSPHONE", when it
  275.           reloads or the -S command line switch is used.
  276.  
  277.           QUIT
  278.           A program to run named "QUIT" will cause the RUNT to quit.
  279.  
  280.           RELOAD
  281.           Using "RELOAD somefile" tells RUNT to reload its instructions
  282.           from the specified 'somefile'.  This allows you to chain
  283.  
  284.  
  285.  
  286.  
  287.  
  288.                RUNT -  The RUN Timer  Manual          Page 6
  289.  
  290.  
  291.           groups of instructions to overcome the 30 instruction limit.
  292.           If you do not include a file name, the RUNT assumes that you
  293.           want to reload from TSPHONE and the events database, so it
  294.           automatically runs the phone program to create a new script
  295.           file.  Any reload that occurs in the first hour of the day
  296.           (just after midnight) includes an automatic CHECKDATE to
  297.           ensure that the RUNT does not use one day's script file on the
  298.           next day.  If no current script file is found the RUNT quits.
  299.  
  300.           WAIT
  301.           The WAIT command can be used on the same line as another
  302.           command to tell the runt program to wait so you can see the
  303.           results of the command.  It is actually a long delay so you
  304.           can include it in scripts that are run when nobody is around.
  305.  
  306.           TODO_NOW  (EVENTS.NOW)
  307.           TODO_NOW is the default name for the file the RUNT reads in to
  308.           get its instructions.  Its alternate name EVENTS.NOW is
  309.           generated automatically from the EVENTS.DBF database by the
  310.           TSPHONE program, and you can also just create or edit an
  311.           existing command file.  Many current users just use their text
  312.           editor to edit and reuse existing command files.
  313.  
  314.           The RUNT is not a TSR or RAM resident program.
  315.  
  316.  
  317.           This product is Copyright (C) 1993-4 P. C. Softsmith all
  318.           rights reserved.  It is distributed as shareware and must be
  319.           distributed with this documentation.  It is normally
  320.           distributed with other P.C. Softsmith materials that further
  321.           explain the shareware process.  If you wish to distribute it
  322.           with your software or are unable to find the other
  323.           documentation that should accompany this file (such as the
  324.           SHR_WARE.DOC, FILE_ID.DIZ, and the VENDOR.DOC) please contact
  325.           whoever gave you the software or P.C. Softsmith.
  326.  
  327.  
  328.           For technical support, either call (604) 433-5189, or write to
  329.           Suite 606 - 6455 Willingdon Avenue, Burnaby, British Columbia,
  330.           Canada, V5H 4E4.  Both registered and soon to be registered
  331.           users currently get the same support without any arbitrary
  332.           time limit.  You may also try leaving a Compuserve message at
  333.           75020, 2664, or send email to
  334.  
  335.           INTERNET:vic_williams@mindlink.bc.ca
  336.  
  337.  
  338.           History:
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.                RUNT -  The RUN Timer  Manual          Page 7
  346.  
  347.  
  348.           November, 1994 - v4.50 encrypted passwords with a master
  349.           password.  Added the -C create calldata.dbf switch.
  350.  
  351.           Minor changes and corrections during most of 1994.
  352.  
  353.           The RUNT gained password control, and user defined 'screen
  354.           saver' capability in version 4 in November, 1993.  Previous
  355.           releases only had events capability.  There is an extant
  356.           ACCESS.exe program with password capability, and a RUNRUN.exe
  357.           program that runs external 'screen savers'.  The RUNT uses
  358.           code and ideas from those other programs, and is a general
  359.           replacement for them.
  360.  
  361.  
  362.           THE DOCUMENTATION AND ASSOCIATED SOFTWARE ARE DISTRIBUTED AND
  363.           SOLD WITH NO WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING
  364.           ITS MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE.
  365.           THE INFORMATION IN THIS DOCUMENTATION IS SUBJECT TO CHANGE
  366.           WITHOUT NOTICE AND DOES NOT REPRESENT A COMMITTMENT ON THE
  367.           PART OF THE VENDOR.
  368.  
  369.           OTHER PRODUCT AND BRAND NAMES MENTIONED ARE TRADEMARKS OR
  370.           REGISTERED TRADEMARKS OF THEIR RESPECTIVE HOLDERS.
  371.           SPECIFICALLY XBASE IS THE GENERIC DATABASE INDUSTRY
  372.           REPLACEMENT FOR THE REGISTERED TERM DBASE OWNED BY BORLAND
  373.           INTERNATIONAL.
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.